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mentation und Archivierung wiederverwend barer Soft- 
ware-Komponenten und zum Auffinden der Software- 
Komponenten uber ein Netzwerk, insbesondere das Inter- 
net. Zur Verbesserung der Auffindbarkeit wird ein System 
vorgeschlagen, bei dem 

a) ein Versionenverwaltungssystem (WS) vorhanden ist, 
das dafiir eingerichtet ist, in einem ersten Dateisystem 
(DS1) Dateien (VD) in unterschied lichen Versionen und 
zusatzlich den jeweils aktuellen Stand der jeweiligen Da- 
tei (VD) als Master-Kopie (MD) zu halten, 

b) an einer zentralen Stelle ein Dokumentationsgenerie- 
rungssystem (DGS) vorhanden ist, das dafiir eingerichtet 
ist, aus den Master-Kopien (MD) HTML-Dokumente (WP) 
zu erzeugen und in ein zweiten Dateisystem (DS2) abzule- 
gen, 

c) eine Suchmaschine (SM) vorhanden ist, die dafiir ein- 
gerichtet ist, jeweils nach einer solchen Dokumentations- 
generierung einen zur Menge der dabei erzeugten HTML- 
Dokumente (WP) gehorigen Index (IN) zu erstellen, und 

d) ein Webserver (WS) vorhanden ist, der mittels der 
Suchmaschine (SM) eine Anfrage an einen Index (IN) er- 
moglicht, und der als Suchergebnis Verweise auf die die 
Suchkriterien erfullenden HTML-Dokumente (WP) liefert, 
die durch Auswahl abrufbar sind. 
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Beschreibung 



Die Erfindung bezieht sich auf ein System zur Documen- 
tation, Archivierung und zum Auffinden wiederverwendba- 
rer Software-Komponenten. 

Wiederverwendung von Software-Komponenten spielt 
eine zentrale Rolle beim Software-Entwurf. Die Herausfor- 
derungen lassen sich im wesentlichen in zwei Gruppen klas- 
sifizieren. Auf der einen Seite muB beim Entwurf von Kom- 
ponenten deren Wiederverwendbarkeit vorbereitet werden. 
Auf der anderen Seite miissen so gewonnene Komponenten 
auffindbar und zugreifbar fur die Wiederverwendung ge- 
macht werden. Auf beiden Seiten entsteht ein Aufwand, der 
hofthungsweise geringer ist als der bei • der Neuerstellung 
der betreffenden Komponente anfallende Aufwand; beson- 
ders, wenn die Zahl der Wiederverwendungen einer Kom- 
ponente steigt. 

In modernen Softwareentwicklungsumgebungen existie- 
ren Werkzeuge, mit denen aus dem Quellcode von Softwa- 
rekomponenten Dokumentation generiert werden kann. Bei- 
spiele fur solche Werkzeuge sind javadoc, ccdoc and idldoc, 
die respektive HTML-Dokumentation fur Java-, C/C++- 
und IDL-Quellcode erzeugen. 

Umgebungen, in denen mehrere Entwickler Software er- 
stellen, werden typischerweise von Konfigurationsverwal- 
tungssystemen unterstiitzt. Diese sorgen fur die Versionie- 
rung von Quellcode und Dokumenten, regeln Aspekte beim 
Erstellen und Konfigurieren von auslieferbaren Produkten 
und unterstutzen in der Regel eine raumlich verteilte Ent- 
wicklung. Bekannte Produkte in diesem Bereich sind z. B. 
ClearCase, PVCS oder Continuus. 

Wiederverwendung erfolgt heute auf Basis von Software- 
Frameworks, -Komponenten und -Bibliotheken. Ein bei jeg- 
licher Art der Wiederverwendung bestehendes Problem 
trifft auch auf diese Technologien zu: namlich die Losung 
der Frage, wie ein Entwickler, der eine Komponente, einen 
Algorithmus oder eine Funktionalitat sucht, diese aus der 
Menge der in einem Unternehmen vorhandenen oder der ex- 
tern kommerziell oder frei verfugbaren Angebote auffinden 
kann. 

Derzeit werden kommerziell verfugbare Komponentenbi- 
bliotheken zunehmend uber elektronische Vertriebswege, 
wie das Internet angeboten und verkauft. Die Auffindbarkeit 
hangt hier von der vom Vertreiber angebotenen Beschrei- 
bung auf der zugehorigen Webseite ab. 

Untemehmensinterne Wiederverwendung von Software- 
komponenten gestaltet sich noch schwieriger, besonders 
wenn in einem Unternehmen an verschiedenen Stellen un- 
abhangig voneinander Software entwickelt wird. Dann gibt 
es fur die Entwickler in der Regel keine Moglichkeit, Kom- 
ponenten aus anderen Projekten, Abteilungen oder Ge- 
schaftsbereichen aufzufinden, um sie in einem anderen Pro- 
jekt wiederzuverwenden. 

Information zum Thema Konfigurationsverwaltungssy- 
stem ist zu finden in: 



e) Software Configuration Management: An Invest- 
ment in Product Integrity by Edward H. Bersoff, Vilas 
D. Henderson, Stanley G. Siegel Prentice Hall, May 
1980, ISBN 0138217696 

f) Practical Software Configuration Management: The 
Latenight Developer's Handbook by Tim Mikkelson & 
Suzanne Pherigo Prentice Hall, April 1997, ISBN 
0132408546 
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a) Software Configuration Management: Coordination 
for Team productivity by Wayne Babich, Addison- 
Wesley, 1986, ISBN 0-201-10161-0 

b) Methods and Tools for Software Configuration Ma- 
nagement by David Whitgift, John Wiley & Sons Ltd., 
November 1991, ISBN 0-471-92940-9 

c) Configuration Management: The Changing Image 
by Marion Kelly, McGraw-Hill, UK, 1995, ISBN 0-07- 
707977-9 

d) Software Configuration Management by Ronald 
Berlack, Wiley Series in Software Engineering Practice 
John Wiley & Sons, July 1991, ISBN 0471530492 



Die Generierung von Dokumentation aus dem Source al- 
leine genugt nicht. Sie ist dadurch nicht fur alle potentiellen 
Verwender zugreifbar. Werkzeuge wie javadoc liefern also 
zwar einen entscheidenden Beitrag, reichen jedoch nicht 
aus. Die Dokumentation ist nicht global auffindbar, und der 
15 Prozefi fur die Generierung ist nicht geregelt. Ohne diese re- 
gelmaBige und haufige Neugenerierung der Dokumentation 
aus den Quellen sind die entstandenen Dokumente rasch 
veraltet. 

Weiterhin ist die Dokumentation nur dann sinnvoll, wenn 
20 zentral Anfragen, z. B. stichwortbasiert oder strukturbasiert 
(z. B. "alle Komponentenpaare, die eine bestimmte Bezie- 
hung zueinander aufweisen"), moglich sind, die dann zu den 
passenden Komponenten im Archiv fuhren. Heutige Losun- 
gen bieten dies nicht. 
25 Der Erfindung liegt daher die Aufgabe zugrunde, eine 
verbesserte Losung des Problems der Auffindbarkeit wie- 
derverwendbarer Software-Komponenten anzugeben. 

Diese Aufgabe wird durch ein System zur Dokumenta- 
tion, Archivierung und zum Auffinden von Software-Kom- 
30 ponenten mit den im Anspruch 1 angegebenen Merkmalen 
gelost. 

Das System basiert auf einer Zusammenfuhrung der vier 
technologischen Komponenten Konfigurationsverwaltungs- 
system, Dokumentengenerierungswerkzeug, Webserver und 
35 Suchmaschine. 

Das Konfigurationsverwaltungssystem sorgt dafur, daB 
Sourcen aus verschiedenen Projekten von verschiedenen 
verteilten Standorten aus bearbeitet, gepflegt und weiterent- 
wickelt werden konnen. Es wird dadurch moglich, an zen- 
40 traler Stelle die Quellcodes zusammenzufiihren. 

Auf den zusammengefuhrten Sourcen konnen dann 
Werkzeuge zur Generierung der Dokumentation angewen- 
det werden. Diese Werkzeuge erstellen aus der Struktur des 
Sourcecodes und den Kornmentaren im Sourcecode Archive 
45 von HTML-Seiten, welche die Beschreibungen samtlicher 
Komponenten und deren Beziehungen untereinander doku- 
mentieren. 

Das Archiv wird durch einen Webserver den zur Verwen- 
dung zugelassenen Entwicklern bereitgestellt. Diese konnen 
50 die HTML-Seite durch einen gewohnlichen Webbrowser 
(Netscape, Internet Explorer) abrufen. 

Durch den Einsatz einer Suchmaschine auf dem erzeug- 
ten Archiv kann in regelmaBigen Abstanden der Archivbe- 
stand indiziert werden, so daB er fur die Anfragesteller per 
55 Stichwort durchsuchbar wird. Somit konnen Anfragen un- 
mittelbar interaktiv beantworlet werden; wobei das Anfra- 
geergebnis im Rahmen der zwischen den Indizierungslaufen 
liegenden Zeit korrekt und vollstandig ist. 
Mit gangigen Betriebssystemen ist es moglich, die Erzeu- 
60 gung der Dokumentation und des Suchindexes in regelmaBi- 
gen Abstanden (z. B. jede Nacht) automatisch durchfuhren 
zu lassen. Somit werden die Entwickler, die wiederverwend- 
bare Komponenten bereitstellen, von der Aufgabe entbun- 
den, die Komponentenbeschreibung anderweitig publizie- 
65 ren zu mussen. Der sowieso durch den EntwicklungsprozeB 
vorgeschriebene Weg, die Sourcen in das Konfigurations- 
verwaltungssystem einzuspielen, bringt somit die Verteilung 
und Auffindbarmachung der Komponentenbeschreibung au- 
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tomatisch mit sich. 

Die Erfindung ist zunachst allgemein anwendbar auf Um- 
gebungen, fur die folgendes zutrifft: 

- Das Konfigurationssystem kann eine vollstandige 5 
Kopie der Quellen an einem Ort zugreifbar machen. 
Dies ist die Voraussetzung dafiir, daB die existierenden 
Dokumentationsgenerierungswerkzeuge ihre Arbeit 
verrichten konnen. Ist diese Randbedingung nicht ge- 
geben, so miiBte ein eigens auf das Konfigurationsma- to 
nagementsystem angepaBtes Werkzeug zur Dokumen- 
tationsgenerierung erstellt werden. 

- Das Dokumentationsgenerierungswerkzeug erzeugt 
HTML-Seiten und kann diese in einem Dateisystem 
persistent ablegen. 15 

Somit konnen die generierten Seiten iiber einen Webser- 
ver zugreifbar gemacht werden. 

Konkret erfullen diese Anforderungen die vorgenannten 
Generierungswerkzeuge javadoc, ccdoc und idldoc, auBer- 20 
dem beispielsweise die Konfigurationsverwaltungssysteme 
ClearCase, Continuus, PVCS, RCS, CVS, SCCS sowie ein 
bei der Fa. ABB entwickeltes, auf RCS basierendes Werk- 
zeug Xtools. Als Betriebssystem kommen alle in Frage, die 
einen zeitgesteuerten Batchbetrieb ermoglichen und auf de- 25 
nen vorgenannte Konfigurauonsverwaltungs- und Doku- 
mentationsgenerierungswerkzeuge laufen. Hierzu zahlen 
unter anderem samtliche Unix-Varianten, aber auch Wind- 
ows 95, 98 und NT. 

Eine weitere Erlauterung des vorgeschlagenen Systems 30 
und seiner Arbeitsweise erfolgt nachstehend anhand der Fig. 
1. 

Fig. 1 zeigt in schematisierter Darstellung die wesentli- 
chen Komponenten des Systems. 

Ein Konfigurations- oder Versionenverwaltungssystem 35 
VVS halt unterschiedliche Versionen von Dateien VD in ei- 
nem ersten Dateisystem DS1, zusatzlich eine "Master- Ko- 
pie" MD fur alle Dateien, also jeweils die aktuellste Version, 
auch "Kopf ' (engl. "Head") genannt. 

Aus der Master-Kopie MD erzeugt ein Dokumentations- 40 
generierungssystem DGS HTML-Seiten WP. Dabei werden 
die erzeugten HTML-Dokumente WP wiederum in ein 
zweites Dateisystem DS2 abgelegt. DS2 kann dabei, muB 
aber nicht identisch mit DS1 sein. 

Auf den Dokumenten WP im zweiten Dateisystem DS2 45 
setzen nun zwei Systeme auf: zum einen ein Webserver WS, 
der den direkten Zugriff auf alle erzeugten Dokumente WP 
erlaubt, auBerdem eine Suchmaschine SM, welche zwei Ak- 
tivitaten verfolgt. Zum einen erstellt die Suchmaschine SM 
nach jeder Dokumentationsgenerierung einen Index IN. 50 
Zum anderen ist die Suchmaschine SM in den Webserver 
WS so eingebunden, da£ eine Anfrage an den ersteilten In- 
dex IN per Webzugriff moglich ist. Die Suchergebnisse wer- 
den dabei so als Webseite prasentiert, daB die gefundenen 
Dokumente wie bei Internet-Suchmaschinen ublich als Ver- 55 
weise eingefiigt werden, die z. B. durch Anklicken direkt 
zum entsprechenden Dokument fuhren. 

In einem ausgefuhrten erfindungsgemaBen System wur- 
den eingesetzt: 

60 

- Xtools als Konfigurationsverwaltungssystem 

- javadoc zum Erzeugen von HTML-Dokumentation 
aus Java Sourcecodes 

- Sun Microsystems Netra-I als Webserver auf Solaris 
2.6 als Betriebssystem 65 

- Swish-E als Suchmaschine. 
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Patentanspriiche 

1. System zur Dokumentation und Archivierung wie- 
derverwendbarer Software-Komponenten und zum 
Auffinden der Software-Komponenten uber ein Netz- 
werk, insbesondere das Internet, wobei 

a) ein Versionenverwaltungssystem (WS) vor- 
handen ist, das dafur eingerichtet ist, in einem er- 
sten Dateisystem (DS1) Dateien (VD) in unter- 
schiedlichen Versionen und zusatzlich den jeweils 
aktuellen Stand der jeweiligen Datei (VD) als Ma- 
ster-Kopie (MD) zu halten, 

b) an einer zentralen S telle ein Dokumentations- 
generierungssystem (DGS) vorhanden ist, das da- 
fur eingerichtet ist, aus den Master- Kopien (MD) 
HTML-Dokumente (WP) zu erzeugen und in ein 
zweites Dateisystem (DS2) abzulegen, 

c) eine Suchmaschine (SM) vorhanden ist, die 
dafur eingerichtet ist, jeweils nach einer solchen 
Dokumentationsgenerierung einen zur Menge der 
dabei erzeugten HTML-Dokumente (WP) gehori- 
gen Index (IN) zu erstellen, und 

d) ein Webserver (WS) vorhanden ist, der mittels 
der Suchmaschine (SM) eine Anfrage an einen In- 
dex (IN) ermoglicht, und der als Suchergebnis 
Verweise auf die die Suchkriterien erfullenden 
HTML-Dokumente (WP) liefert, die durch Aus- 
wahl abrufbar sind. 

2. System nach Anspruch 1, dadurch gekennzeichnet, 
daB das erste und das zweite Dateisystem (DS1, DS2) 
zu einem gemeinsamen Dateisystem zusammengefaBt 
sind. 

3. System nach Anspruch 1 oder 2, dadurch gekenn- 
zeichnet, daB der Webserver (WS) dafiir eingerichtet 
ist, die HTML-Dokumente (WP) auch direkt, also ohne 
Mitwirkung der Suchmaschine (SM), abzurufen. 

4. System nach einem der vorstehenden Anspriiche, 
dadurch gekennzeichnet, daB das Versionenverwal- 
tungssystem (WS) ausgewahlt ist aus den Systemen 
ClearCase, Continuus, PVCS, RCS, CVS, SCCS und 
Xtools. 

5. System nach einem der vorstehenden Anspriiche, 
dadurch gekennzeichnet, daB das Dokumentationsge- 
nerierungssystem (DGS) ausgewahlt ist aus den Syste- 
men javadoc, ccdoc, und idldoc. 
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